home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / sysstat / RCS / sysstat.man,v < prev   
Encoding:
Text File  |  1992-05-23  |  4.5 KB  |  197 lines
  1. head     1.4;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    ; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.4
  10. date     92.05.22.18.35.55;  author kupfer;  state Exp;
  11. branches ;
  12. next     1.3;
  13.  
  14. 1.3
  15. date     88.12.30.10.18.11;  author ouster;  state Exp;
  16. branches ;
  17. next     1.2;
  18.  
  19. 1.2
  20. date     88.12.22.11.59.41;  author ouster;  state Exp;
  21. branches ;
  22. next     1.1;
  23.  
  24. 1.1
  25. date     88.12.06.13.59.55;  author douglis;  state Exp;
  26. branches ;
  27. next     ;
  28.  
  29.  
  30. desc
  31. @man page for sysstat.
  32. /.
  33. @
  34.  
  35.  
  36. 1.4
  37. log
  38. @Add -p, -t.
  39. @
  40. text
  41. @' $Header: /sprite/src/cmds/sysstat/RCS/sysstat.man,v 1.3 88/12/30 10:18:11 ouster Exp Locker: kupfer $ SPRITE (Berkeley)
  42. .so \*(]ltmac.sprite
  43. .HS SYSSTAT cmds
  44. .BS
  45. .SH NAME
  46. sysstat \- print statistics and information about the state of the system
  47. .SH SYNOPSIS
  48. \fBsysstat \fR[\fB\-vcR\fR]
  49. .SH OPTIONS
  50. .IP "\fB\-v\fR" 14
  51. Print out the compilation version timestamp for the kernel.  This is
  52. the default if no options are specified. 
  53. .IP "\fB\-c\fR" 14
  54. Print out the number of times each system call has been invoked.
  55. .IP "\fB\-p\fR \fIn\fR" 14
  56. Enable or disable system call timing.
  57. .IP "\fB\-t\fR" 14
  58. For each system call, print the number of calls and how much time was
  59. required. 
  60. .IP "\fB\-R\fR" 14
  61. Reset the count and time information for system calls.
  62. .BE
  63.  
  64. .SH DESCRIPTION
  65. .LP
  66. This command prints out statistics and other information about the
  67. system.   
  68. .SH "VERSION TIMESTAMP"
  69. .IP "\fB\-v\fR"
  70. By default, \fBsysstat\fR prints the compilation version timestamp for the
  71. kernel.  This is a unique identifier indicating who compiled the
  72. kernel and when.  This information is printed if no options are
  73. specified, or if the \fI-v\fR  option is specified.  
  74. .SH "SYSTEM CALL STATISTICS"
  75. .IP "\fB\-c\fR"
  76. This option indicates that \fBsysstat\fR should display a count of the
  77. number of times each system call has been invoked.  For each call, the
  78. number of invocations is printed along with an indication of whether
  79. the call, if done by a migrated process, would be handled locally or
  80. would require action by the process's \fIhome node\fR.
  81. .IP "\fB\-t\fR"
  82. This option tells 
  83. .B sysstat
  84. to display for each system call the number of times the call was
  85. invoked, the total time spent in that call, and the average time spent
  86. in that call.  Note that if a process is migrated, its system calls
  87. are recorded by the host that it is executing on, rather than by the
  88. home node.  Normally system call timing is turned off; use the
  89. .B \-p 
  90. option to turn it on.
  91. .IP "\fB\-R\fR"
  92. This option causes \fBsysstat\fR reset the kernel's count of the
  93. number of times each system call has been invoked, as well as the
  94. accumulated time for each system call.  Thus, subsequent invocations of
  95. \fBsysstat\fR with the \fB\-c\fR or \fB\-t\fR option will report only
  96. activity since the invocation with the \fB-R\fR option.
  97. .IP "\fB\-p\fR"
  98. This option controls whether Sprite keeps track of how much time each
  99. system call takes.  To turn on system call timing, use 
  100. .BR "\-p 1" ;
  101. to turn it off, use
  102. .BR "\-p 0" .
  103. .SH BUGS
  104. System call timing is only available on ds5000s.
  105. .SH "SEE ALSO"
  106. migcmd, fscmd
  107. .SH KEYWORDS
  108. statistics, process migration, system call
  109. @
  110.  
  111.  
  112. 1.3
  113. log
  114. @More format upgrades.
  115. @
  116. text
  117. @d1 1
  118. a1 1
  119. ' $Header: /a/newcmds/sysstat/RCS/sysstat.man,v 1.2 88/12/22 11:59:41 ouster Exp Locker: ouster $ SPRITE (Berkeley)
  120. d15 5
  121. d21 1
  122. a21 1
  123. Reset the count of the number of times each system call has been invoked.
  124. d41 10
  125. d52 13
  126. a64 4
  127. This option causes \fBsysstat\fR to perform a system call to reset the
  128. kernel's count of the number of times each system call has been
  129. invoked.  Subsequent invocations of \fBsysstat\fR with the \fI-c\fR  option
  130. will report the count of calls since the invocation with the \fI-R\fR option.
  131. @
  132.  
  133.  
  134. 1.2
  135. log
  136. @*** empty log message ***
  137. @
  138. text
  139. @d1 1
  140. a1 1
  141. ' $Header: /a/newcmds/sysstat/RCS/sysstat.man,v 1.1 88/12/06 13:59:55 douglis Exp $ SPRITE (Berkeley)
  142. d8 1
  143. a8 1
  144. \fBsysstat \fR[\fB-vcR\fR]
  145. d10 1
  146. a10 1
  147. .IP "\fB-v\fR" 14
  148. d13 1
  149. a13 1
  150. .IP "\fB-c\fR" 14
  151. d15 1
  152. a15 1
  153. .IP "\fB-R\fR" 14
  154. d24 2
  155. a25 2
  156. .IP "\fB-v\fR"
  157. By default, sysstat prints the compilation version timestamp for the
  158. d30 2
  159. a31 2
  160. .IP "\fB-c\fR"
  161. This option indicates that sysstat should display a count of the
  162. d36 2
  163. a37 2
  164. .IP "\fB-R\fR"
  165. This option causes sysstat to perform a system call to reset the
  166. d39 1
  167. a39 1
  168. invoked.  Subsequent invocations of sysstat with the \fI-c\fR  option
  169. @
  170.  
  171.  
  172. 1.1
  173. log
  174. @Initial revision
  175. @
  176. text
  177. @d1 3
  178. a3 2
  179. ' $Header: vmstat,v 1.1 88/08/15 15:53:07 nelson Exp $ SPRITE (Berkeley)
  180. .TH sysstat prog
  181. d5 1
  182. a5 1
  183. .NA
  184. d7 1
  185. a7 1
  186. .SY
  187. d24 1
  188. a24 1
  189. .LP "-v"
  190. d30 1
  191. a30 1
  192. .LP "-c"
  193. d36 1
  194. a36 1
  195. .LP "-R"
  196. @
  197.